Zum Hauptinhalt springen

UI-Element oder aktuelle Seite scrollen (ui_element.scroll)

Diese Funktion ist erst in Versionen nach 20260507 verfügbar.

Deklaration​

Status, Information_oder_Fehlermeldung = ui_element.scroll(Richtung [, Optionen ])
Status, Information_oder_Fehlermeldung = ui_element.scroll(Selektor_oder_Element, Richtung [, Optionen ])

Parameter​

  • Selektor_oder_Element
    Optionaler Parameter, Tabellenwert; kann ein Selektor, ein von einer Abfrage zurückgegebenes Element oder eine Koordinatentabelle { x = X-Koordinate, y = Y-Koordinate } sein.
  • Richtung
    Textwert; unterstützt werden "down", "up", "left", "right", "top" und "bottom".
  • Optionen
    Optionaler Parameter, Tabellenwert; mit point, x und y kann der Trefferpunkt und mit steps der Schrittparameter festgelegt werden.

Rückgabewert​

  • Status
    Boolescher Wert; bei Erfolg true, bei einem Fehler nil.
  • Information_oder_Fehlermeldung
    Bei Erfolg Aktionsinformationen als Tabellenwert, bei einem Fehler die Fehlerursache als Textwert.

Beschreibung​

Ohne Selektor wird standardmäßig versucht, die aktuelle Seite zu scrollen. Mit einem Selektor wird versucht, den scrollbaren Bereich des Zielelements zu scrollen. Wenn mehrere Seiten zuverlässig gescrollt werden müssen, sollte die Funktion in einem Lua-Skript wiederholt aufgerufen und die Seitenänderung selbst geprüft werden.

Beispiel​

local ui_element = require("ui_element")

ui_element.scroll("down", {
point = { x = 200, y = 700 },
})

ui_element.scroll({
text_contains = "列表",
}, "up")